!rtems
Displays summary and statistical information for the external memory allocation space (MSpace) of a process. The command shows MSpace’s control flags, parameters, and memory usage. When supplied with an optional info level, the command also shows memory usage within the local pool and pool cache, top block, and the settings for trimming.
Syntax
!rtems <process> <info_level>
Parameters
process
RTSS process address. This parameter is required.
info_level [optional]
A ULONG number to specify the display level.
| Parameter | Information Displayed |
|---|---|
|
0 or no value provided (default) |
Display MSpace’s control flags, parameters, and memory usage. |
|
1 |
Display MSpace’s control flags, parameters, and memory usage for the local pool and pool cache. |
| 2 | Display MSpace’s control flags, parameters, memory usage for the local pool and pool cache, top block and the settings for trimming. |
Remarks
For a glossary of common terms found in command output, see RTX64 WinDbg Extension Commands Glossary.
This command is supported for:
Requirements
| Minimum Supported Version | RTX64 4.0 |
Examples
Example of !rtems without info_level
!rtems 0xffffcf0ab70e0010 Process 0xffffcf0ab70e0010 External MSpace Summary Information MSpace descriptor: 0xffffcf0ab70e9530 MSpace minimum size (bytes): 0x0000000000100000 Commit memory at process startup: False Auto expand MSpace: True Auto expand size (bytes): 0x0000000000100000 Auto shrink MSpace: True MSpace peak usage (statistical maximum bytes): 0x00000000fde90000 OS memory taken by MSpace (bytes): 0x0000000005959000 Total MSpace (bytes): 0x00000000058ffe00 Free MSpace (bytes): 0x00000000058f6d40 Used MSpace (bytes): 0x00000000000090c0 Largest contiguous free block (bytes): 0x00000000000effb0
Example of !rtems with info_level 1
!rtems 0xffffcf0ab70e0010 1 Process 0xffffcf0ab70e0010 External MSpace (Pool and Cache) Summary Information MSpace descriptor: 0xffffcf0ab70e9530 MSpace minimum size (bytes): 0x0000000000100000 Commit memory at process startup: False Auto expand MSpace: True Auto expand size (bytes): 0x0000000000100000 Auto shrink MSpace: True MSpace peak usage (statistical maximum bytes): 0x00000000fde90000 OS memory taken by MSpace (bytes): 0x0000000005959000 Total MSpace (bytes): 0x00000000058ffe00 Free MSpace (bytes): 0x00000000058f6d40 Used MSpace (bytes): 0x00000000000090c0 Largest contiguous free block (bytes): 0x00000000000effb0 Total Local Pool (bytes): 0x00000000058ffe00 Free Local Pool (bytes): 0x000000000066c6e0 Used Local Pool (bytes): 0x0000000005293720 Total Pool Cache (bytes): 0x000000000528f4e0 Free Pool Cache (bytes): 0x000000000528a660 Used Pool Cache (bytes): 0x0000000000004e80 Free blocks in Pool Cache: 0x000000000000005b
Example of !rtems with info_level 2
!rtems 0xffffcf0ab70e0010 2 Process 0xffffcf0ab70e0010 External MSpace (Pool, Cache, Top Block) Summary Information MSpace descriptor: 0xffffcf0ab70e9530 MSpace minimum size (bytes): 0x0000000000100000 Commit memory at process startup: False Auto expand MSpace: True Auto expand size (bytes): 0x0000000000100000 Auto shrink MSpace: True MSpace peak usage (statistical maximum bytes): 0x00000000fde90000 MSpace current usage (bytes): 0x0000000005290000 MSpace usage limit: Disabled The lowest address in MSpace: 0xffffcf0ab70e9520 OS memory taken by MSpace (bytes): 0x0000000005959000 Total MSpace (bytes): 0x00000000058ffe00 Free MSpace (bytes): 0x00000000058f6d40 Used MSpace (bytes): 0x00000000000090c0 Largest contiguous free block (bytes): 0x00000000000effb0 Total Local Pool (bytes): 0x00000000058ffe00 Free Local Pool (bytes): 0x000000000066c6e0 Used Local Pool (bytes): 0x0000000005293720 Total Pool Cache (bytes): 0x000000000528f4e0 Free Pool Cache (bytes): 0x000000000528a660 Used Pool Cache (bytes): 0x0000000000004e80 Free blocks in Pool Cache: 0x000000000000005b Top block size in Pool Cache (bytes): 0x000000000002ffb0 Top block address: 0xffffcf0be1851000 Top block size starting to trim (bytes): 0x0000000000200000 The number of frees before trimming: 0x00000000000009e6
